home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / ddjr15.zip / DDJR.DOC < prev    next >
Text File  |  1992-02-22  |  10KB  |  219 lines
  1.             * * * * * * * * * * * * * * * * * * * * * * * * *
  2.             *                                               *
  3.             *               DIAMOND DICE JR                 *
  4.             *                 VERSION 1.5                   *
  5.             *                   02/22/91                    *
  6.             *                                               * 
  7.             *                  Written By:                  *
  8.             *                 Michael Goetz                 *
  9.             *                                               *
  10.             *            Copyright (c)  1991, 1992          *
  11.             *               All Rights Reserved             *
  12.             *                                               *
  13.             *                 SUPPORT  BBS:                 *
  14.             *               The SpeakEasy BBS               *
  15.             *                 (407) 291-4626                * 
  16.             *         PCB 14.5 * HST D/S 1200-38,400        *
  17.             *                                               *
  18.             * * * * * * * * * * * * * * * * * * * * * * * * * 
  19.  
  20. INTRODUCTION
  21. ------------
  22.  DIAMOND DICE JR is a fun, addictive, fast-paced game door for
  23.  Bulletin Board Systems.  Playing the game is easy to learn. The
  24.  object of the game is to remove as many numbers from the DIAMOND
  25.  as you can,  and accumulate as many points as possible.  After
  26.  completing a game, scores are posted to the Top Score file and,
  27.  when registered, will be posted to a colorful graphic bulletin!
  28.  
  29. FEATURES
  30. --------
  31.  - ANSI color and Mono screens
  32.  - Supports up to 230k bps!
  33.  - Supports most BBS Software
  34.  - Supports Multi-node Systems
  35.  - Supports non-standard port & IRQ
  36.  - Supports FOSSIL drivers
  37.  - Easy installation and maintainance
  38.  - Creates graphic/non-graphic bulletin (Reg. Req.)
  39.  - Automatically maintained Bulletin/Top Score
  40.                               
  41. INSTALLATION
  42. ------------
  43.  Installation is very easy.  Create a directory to hold all the DIAMOND
  44.  DICE JR files and unzip DDJRxx.ZIP into this directory.
  45.  
  46.  Files should consist of:
  47.   DDJR15.EXE   .... Main program file
  48.   DDJSETUP.EXE .... Setup utility to create configuration file (DDICE.CFG)
  49.   DDJR.INS   ...... On-line Instruction file
  50.   DDJR.USR   ...... User file (NOTE: MUST have to operate game!)
  51.   DDJR       ...... Sample batch file (modify as needed)
  52.   DDJR.CFG   ...... Sample configuration file (read by DDSETUP.EXE)
  53.   DDJKILL.EXE ..... Bulletin - Top Score maintainance file
  54.   DDJR.DOC    ..... You're reading it!
  55.   REGISTER.FRM .... Please use it... I need the money !!   :-)
  56.   WHATSNEW.TXT .... History text file
  57.   FILE_ID.DIZ ..... Description file (for PCB 14.5a only)
  58.  
  59.  Change to the directory you created and run DDJSETUP.EXE and enter the
  60.  data in the fields as applicable to your system.  The first line will 
  61.  ask for the full path and filename of your BBS information file.  For
  62.  example: C:\PCB\PCBOARD.SYS.  DIAMOND DICE JR uses this information to
  63.  determine the BBS software which is being used as follows:
  64.  
  65.  PCBOARD.SYS   (PCBoard)
  66.  CALLINFO.BBS  (Wildcat!)
  67.  DOORS.SYS     (Spitfire)
  68.  DOOR.SYS      (GAP and other systems using std. DOOR.SYS)
  69.  DORINFOx.DEF  (QuickBBS/Remote Access)
  70.  
  71.  NOTE: DO NOT EXCEED 35 CHARACTERS FOR THE SYSTEM PATH!!
  72.  
  73.  Line <4> will ask for the path and name for the Non-Graphic Bulletin
  74.  file that will be created after each completed game.  The Bulletin 
  75.  will only be created with the REGISTERED VERSION.  Until registered, 
  76.  place "NONE" in this field.  
  77.  
  78.  Line <5> will ask for the path and name for the Graphic Bulletin file
  79.  that will be created after each completed game.  The Bulletins will
  80.  only be created with the REGISTERED VERSION.  Until registered, place
  81.  "NONE" in this field.
  82.  
  83.  Line <6> will ask for the registration code number.  Until the program
  84.  is registered, place 0000 in the Registration field.
  85.  
  86.  Line <7> will ask how many GAMES per day you wish to allow each user
  87.  (max. of 10).  NOTE: UNREGISTERED VERSION will only allow 2 games per
  88.  day.  Enter 2 in this field until registered.
  89.  
  90.  Line <8> asks for the total number of Top Scores to write to the
  91.  Top Score File and Bulletin.  NOTE: UNREGISTERED VERSION forces 5.
  92.  Until registered, please enter 5 into this field.
  93.  
  94.  NOTE: ALL FIELDS *MUST* BE FILLED IN OR PROGRAM FAILURE WILL OCCUR !!
  95.  ---------------------------------------------------------------------
  96.  
  97.  After entering all of the information, exit DDJSETUP.EXE by pressing
  98.  <S>ave....  This will create the DDJR.CFG file and place it in the
  99.  current directory.  
  100.  
  101.  Consult your BBS Software manual on how to create a DOOR batch file,
  102.  and modify the DDJR batch file supplied.  An example batch file for
  103.  PCBoard:
  104.  
  105.   @Echo off
  106.   C:
  107.   CD\PCB\DOORS\DDJR
  108.   DDJR15 DDJR.CFG         <---- This is the command line for calling
  109.   C:                            DIAMOND DICE JR. MUST BE THE SAME or 
  110.   CD\PCB                        failure will occur !!  For non-standard
  111.   BOARD.BAT                     port address and IRQ, see NOTE below!
  112.  
  113.  NOTE: If you need to specify a non-standard port address and IRQ,
  114.        then you will need to add this information to the BATCH file
  115.        calling DIAMOND DICE JR. The syntax is PORT:AAAA:X where AAAA is
  116.        the base address and X is the IRQ. An example batch file:
  117.  
  118.              @echo off
  119.              c:
  120.              cd\pcb\doors\ddjr
  121.              ddjr15 ddjr.cfg PORT:03E8:5  <---- NEW COMMAND LINE!
  122.              c:
  123.              cd\pcb
  124.              board.bat
  125.  
  126.        DIAMOND DICE JR will also support use of FOSSIL drivers. The
  127.        syntax for a FOSSIL driver is: PORT:F:P.  The 'F' tells the
  128.        door to use a Fossil driver for it's communications, and the 
  129.        'P' following it tells it which port to use for the Fossil.
  130.        Example: PORT:F:1 tells it to use a Fossil driver for port 1.
  131.  
  132.  DDJKILL.EXE is a utility that can be called from the EVENT.SYS (or the
  133.  equivalent for your BBS Software) that will automatically, on the 1st
  134.  of each month, create/update the "Last Month's Top Scorer" (which is
  135.  displayed on the Top Score screen and the Bulletin after registering). 
  136.  It will also delete the previous month's Top Scores (DDJR.SCR), making
  137.  DIAMOND DICE JR virtually maintainance free! It will only execute if run
  138.  on the 1st of the month.
  139.  
  140.  NOTE: DDJKILL.EXE can be forced to run by entering "DDJKILL /u" if desired.
  141.  WARNING: This will delete the Top Score file !!
  142.  
  143. MULTI-NODE SYSTEMS
  144. ------------------
  145.  When running more than one node, be sure to have a different configuration
  146.  for each node, and create a batch file for each node.  The configuration
  147.  file for each node can be created easily by entering at the dos prompt:
  148.  DDJSETUP DDJRx.CFG, where 'x' is the node number.   This will cause
  149.  DDJSETUP.EXE to create a configuration file under the name entered rather
  150.  than the default (DDJR.CFG).
  151.  
  152.  Example DDJR2.BAT file:           Example DDJR2.CFG:
  153.  ------------------------           -------------------
  154.  @echo off                         <1> c:\pcb2\pcboard.sys  <--- path to
  155.  c:                                <2> The SpeakEasy BBS         node 2
  156.  cd\pcb\doors\DDJR                 <3> Michael Goetz             system
  157.  DDJR15 DDJR2.CFG                      ....and so on             file.
  158.  c:
  159.  cd\pcb2
  160.  board2.bat
  161.  
  162. REGISTRATION !!
  163. ---------------
  164.  Registration is required if you choose to continue using this door
  165.  program after a 3 or 4 week evaluation period.  When registered, the
  166.  "[UNREGISTERED EVALUATION COPY]" line will be replaced with the name
  167.  of your BBS followed by the SysOp name as well as the removal of the 
  168.  delay built into the opening and closing screens.  Registration will
  169.  also allow you the following features:
  170.  
  171.  -- Creation of a colorful graphic Top Score Bulletin which is updated
  172.     after each completed game.
  173.  -- The total number of Top Scores posted can also be specified in the
  174.     configuration file (maximum of 50).
  175.  -- The amount of GAMES allowed each user per day (max of 10) can be
  176.     specified in the configuration file.
  177.  -- The amount of CHANCES (0-6) each player is given at game start can
  178.     be specified in the configuration file.
  179.  
  180.  To register your copy of DIAMOND DICE JR, please fill out the supplied
  181.  registration form (REGISTER.FRM) and mail it along with a small
  182.  donation of $20.00 or $25.00 (check or Money Order) payable to
  183.  Michael Goetz, address on the form.   Please be sure you enter the
  184.  information on the form as it appears in the DDJR.CFG file.   Your
  185.  registration code is based upon this information!
  186.  
  187.  After receiving your registration form, I will pre-register you on the
  188.  SpeakEasy BBS.  You will then be able to call the SpeakEasy and receive
  189.  your registration code. Please allow at least 7 days prior to calling.
  190.  If you prefer, I will mail your registration code if you supply a self-
  191.  addressed stamped envelope.   PLEASE SUPPORT SHAREWARE!!
  192.    
  193. APPRECIATION
  194. ------------
  195.  I would like to thank Steve Page, SysOp of the SpeakEasy BBS, and Jim
  196.  Murphey, SysOp of the Coffee Shop BBS, for beta testing the program. 
  197.  Their assistance in the development of DIAMOND DICE JR is sincerely
  198.  appreciated.
  199.  
  200. SUPPORT
  201. -------
  202.  If you have any questions concerning the setup or operation of
  203.  DIAMOND DICE JR, I can be reached via email thru PCRelay's (RIME)
  204.  BBS-DOORS conference or at The SpeakEasy BBS, Majic Software's
  205.  support BBS.
  206.  
  207. LEGALITIES
  208. ----------
  209.  THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  210.  WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  211.  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  212.  IN NO EVENT SHALL THE AUTHOR OR ANYONE INVOLVED WITH THE CREATION AND PRO-
  213.  DUCTION OF THIS PRODUCT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR
  214.  CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THIS PROGRAM.  YOUR USE OF 
  215.  THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO THIS DISCLAIMER AND YOUR RELEASE
  216.  OF THE AUTHOR FROM ANY FORM OF LIABILITY OR LITIGATION.
  217.  
  218.                                 - END - 
  219.